home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / bootup / boot_n2z / randplay / randplay.txt < prev    next >
Text File  |  1995-05-02  |  6KB  |  175 lines
  1.                    RANDPLAY - Sample Replay Program
  2.                     Copyright 1992 Martin H. Smith
  3.                           All Rights Reserved
  4.               Replay Sound Tables Copyright 2-Bit Systems
  5.  
  6. Introduction
  7.  
  8. The  3 programs in this archive are sample  playback,  compression  and 
  9. conversion utilities.
  10.  
  11. The  playback program is more flexible than others of similar  function 
  12. and  thanks  to the REPLAY sound tables it sounds better and  can  cope 
  13. with higher replay frequencies.
  14.  
  15. The  basic task of RANDPLAY is to choose a sample from a list and  play 
  16. it at boot time.  There are no silly limits on the number of samples in 
  17. the list.
  18.  
  19. Installation and Boot Usage
  20.  
  21. Copy RANDPLAY.PRG to the AUTO folder of the boot disk. Copy it again to 
  22. the bin directory of your shell (often C:\BIN) and rename this copy  to 
  23. RANDPLAY.TTP. Copy the other .TTP files to the BIN directory.
  24.  
  25. Now create a list of samples.  Create the file RANDPLAY.INF in the root 
  26. directory of the boot drive and place lines similar to the following in 
  27. it,  depending  on where your samples are and what speed you want  them 
  28. played at.  
  29.  
  30. # RANDPLAY.INF file last edited MHS 23/1/92. PLAY.PRG Beater!
  31.  
  32. f:\replay\mysample\aliens.spl 10000
  33. f:\replay\mysample\compl22.spl 22000
  34. f:\replay\mysample\cylinder.spl 9800
  35. f:\replay\mysample\daleks.spl 16000
  36. f:\replay\mysample\darksta2.sam 9200
  37.  
  38. Lines starting with '#' are comments. If you have samples saved in .AVR 
  39. or BYTEPACK format the numeric parameter is not required as their speed 
  40. is stored in the file.
  41.  
  42. Now  reboot.  There should be a sign on message from RANDPLAY and  then 
  43. a randomly chosen sample will be loaded and played.  During replay  hit 
  44. the SPACE bar to start playing again or the UNDO key to stop playback.
  45.  
  46. Command Line Playback
  47.  
  48. When  the program is passed command lines from a CLI there are  several 
  49. other features available.
  50.  
  51. Command lines are one of the forms:
  52.  
  53. RANDPLAY -t <inf_file>
  54. RANDPLAY sample_file [speed]
  55. RANDPLAY inf_file
  56.  
  57. With the -t option the program attempts to open all the files listed in 
  58. the  given  .INF file or the default one if a name was  not  specified. 
  59. This  helps avoid annoying problems with mistyped filenames which  only 
  60. come  up once in 50 boots or so.  When this happens GEM then  helpfully 
  61. clears the screen of the error message (what an operating system).
  62.  
  63. RANDPLAY my.inf picks a random sample from the ones listed in my.inf
  64.  
  65. RANDPLAY  x.avr  plays the sample x.avr (the AVR  format  includes  the 
  66. replay speed in the sample header)
  67.  
  68. RANDPLAY  x.spl  20000 plays back the sample x.spl at  20Khz.  For  raw 
  69. sound data you have to give a speed.
  70.  
  71. What  happens is that if the file extension is .INF it gets treated  as 
  72. a text file giving a list of samples and playback speeds.  Otherwise if 
  73. a  speed was given it is loaded raw else it must have an AVR header  or 
  74. be a packed file (see below).
  75.  
  76. All  the  playback commands can be preceded with a -c  option  to  play 
  77. back through a REPLAY sampler cartridge instead of the monitor. This is 
  78. the cartridge I use for all my sampling and is highly recommended.
  79.  
  80. Desktop Picture Selection
  81.  
  82. RANDPLAY can be used in conjunction with a popular desk accessory  that 
  83. displays a high resolution DEGAS picture as the desktop background. The 
  84. accessory requires a file called DESKTOP.P?3 in the root directory.
  85.  
  86. To  use  the picture randomiser create a DESKTOPS subdirectory  of  the 
  87. AUTO folder and copy all the pictures you wish to select from into it.
  88. Then  every few reboots a random one will be chosen and copied  to  the 
  89. root directory.
  90.  
  91. If  the  DESKTOPS subdirectory is not present the feature  is  silently 
  92. disabled.
  93.  
  94. Running  RANDPLAY with an argument of -desk will force a desktop change
  95. if you get bored with the one you have.
  96.  
  97. Using BYTEPACK.TTP
  98.  
  99. This  is used to compress samples by 50 percent by combining  the  most 
  100. significant halves of two samples into one byte.
  101.  
  102. It  can  give quite good quality results on some signals but  can  also 
  103. sound  utterly disastrous on others.  It is recommended that you  don't 
  104. use  it  on your only copy of a prized sample !  It can be  useful  for 
  105. saving disk space on lower speed speech samples.
  106.  
  107. Samples  packed in this manner can be played back by RANDPLAY  but  you 
  108. will  not  be able to load them into sample editors or play  them  with 
  109. other programs.
  110.  
  111. You  give it a command such as BYTEPACK x.spl 20000 which produces  the 
  112. packed file x.bps.  The RANDPLAY program detects these format files  so 
  113. you just then say RANDPLAY x.bps
  114.  
  115. Using SPL2AVR.TTP
  116.  
  117. Used to convert raw sample data to AVR format samples. Basically adds a 
  118. header.
  119.  
  120. Usage is SPL2AVR [-mac] input_file output_file speed
  121.  
  122. Where the output file defaults to input file with a .AVR extension.
  123.  
  124. For example SPL2AVR x.spl 20000
  125.  
  126. The  -mac option converts from mac style unsigned samples to  signed  8 
  127. bit.  I hope to add Sparc format conversion later but these are  stored 
  128. in a logarithmic encoding which will be a bit trickier.
  129.  
  130. License
  131.  
  132. These programs are NOT Shareware.  I wrote them for my own use and  the 
  133. total development time was small. The programs are provided to you free 
  134. of  charge  for  non commercial use and come with no  warranty  of  any 
  135. kind.  Every care has been taken in the production of the software  but 
  136. you must decide whether they meet your needs and if so accept any risks 
  137. of using them.
  138.  
  139. The software may be freely reproduced and circulated as long as no  fee 
  140. is charged for such reproduction. These programs may not be included on 
  141. a magazine cover disk without the permission of the author.
  142.  
  143. SPECIAL NOTE FOR PD LIBRARIES:  You must distribute the entire  archive 
  144. complete and unmodified INCLUDING THE BLOODY DOCUMENTATION. I'm sick of 
  145. having my work mangled by you idiots.
  146.  
  147. Problems with the software may be reported to me at the address  below. 
  148.  
  149. Credits
  150.  
  151. A very big hi to Maggie again
  152. The Escape Committee - keep tunnelling lads
  153. Andy Webber
  154. Moira
  155. Nikki & Nikki
  156. Jas Brooke
  157. JEF
  158.  
  159. Contact
  160.  
  161. Pigeon post:
  162.  
  163. Martin Smith,
  164. 47 Leeds Road,
  165. Allerton Bywater,
  166. Castleford,
  167. W. Yorks,
  168. WF10 2ES,
  169. UK.
  170.  
  171. Email (preferred): 
  172.  
  173. msmith@lssec.bt.co.uk
  174.  
  175.